addnode

使用 addnode 命令可向现有系统添加新(候选)节点。创建系统后,可随时输入此命令。如果要向系统添加节点,请确保现有系统的系统代码(代码)版本支持该新节点的型号类型。如果代码不支持该型号类型,请将系统升级至支持新节点型号类型的代码版本。

语法

阅读语法图跳过直观语法图 addnode -panelnamepanel_name-wwnodenamewwnn_name-namenode_name-spare -iogrpiogroup_nameiogroup_id-sitesite_namesite_id

参数

-panelname panel_name
(在未指定 -wwnodename 参数时为必需)根据管理 GUI 中、服务助手中或通过指定 lsnodecandidate 所显示的名称,指定要添加到系统的节点。不能将该参数与 -wwnodename 参数一起使用。
注: 如果未提供 panel_name,那么该命令适用于正在运行命令的节点。
-wwnodename wwnn_name
(在未指定 -panelname 参数时为必需)根据全球节点名 (WWNN) 指定要添加到系统的节点。不能将此参数与 -panelname 参数一起使用。
-name node_name
(可选)为要添加到系统的节点指定名称。您可以在后续命令中使用该名称(而不是使用节点标识)来指代该节点。
注: addnodechnode 命令上通过 -name 参数提供的节点名不能已用作节点 名或节点 failover_names

如果分配了一个名称,那么该名称将从此显示为节点名。如果未分配名称,那么将使用缺省名称。使用的缺省名称取决于节点是否替换先前被删除的节点。如果节点被删除,那么其名称将作为伙伴节点的故障转移名称保留在 I/O 组中。如果没有节点保留在 I/O 组中,将不保留任何故障转移名称。每个节点只能存储一个故障转移名称。如果将节点添加到具有保留的故障转移名称的 I/O 组中并且未指定节点名,那么会将该保留的故障转移名称分配给该节点。如果未指定名称并且没有任何保留的故障转移名称,那么分配的名称将使用格式 nodeX

要点: 每个节点的 iSCSI 限定名 (IQN) 使用系统和节点名生成。如果要使用 iSCSI 协议、该节点的目标名称已在其伙伴节点上处于活动状态并且将 iSCSI 主机与其连接,那么使用另一个名称添加该节点会更改系统中该节点的 IQN,并且可能需要重新配置所有 iSCSI 连接的主机。
-spare
(可选)指定要添加的节点是备用节点,而不是 I/O 节点组成员。 不能将此参数与 -iogrp 一起指定。
-iogrp iogroup_name | iogroup_id
(必需)指定要将该节点添加到的 I/O 组。 不能将此参数与 -spare 一起指定。
-site site_name | site_id
(可选)指定新节点的数字站点值或站点名称。

如果系统拓扑是 hyperswap 且 I/O 组有已配置节点,那么此新节点必须位于同一站点内。 如果 I/O 组中不存在已配置的节点(但在处于 active-active 关系的 I/O 组中定义了卷),那么此新节点必须与先前位于此 I/O 组中的任何节点位于同一站点内。

切记:
  • 必须指定该参数,不管系统拓扑设置为 stretched 还是 hyperswap
  • 如果系统拓扑为 stretched 且 I/O 组具有已配置节点,那么此新节点必须位于其他站点位置。

描述

该命令用于向系统添加节点。 您可以通过输入 lsnodecandidate 来获取候选节点(尚未分配给系统的节点)的列表。 不能添加内存小于 I/O 组中任何潜在伙伴节点内存的节点。

您可以在所有节点类型的数据降维存储池中创建自动精简配置卷。必须在具有支持压缩的节点类型的 I/O 组中创建数据降维存储池中的压缩卷。可以将支持压缩的节点添加到包含压缩卷的 I/O 组中。

如果新节点为以下情况,那么不能使用此命令:
  • 无法加密,但是现有 I/O 组伙伴可加密。
  • 无法加密,但是存在使用加密密钥但包含不进行自加密的 MDisk 的存储池。
  • 能够加密,但是节点或机柜没有加密许可证。

如果在系统上启用了加密,那么必须通过使用管理 GUI 针对每个新的 MTM 序列安装一个新的加密许可证,然后才能将新节点或机柜添加到系统。

注: 只有当节点机柜系统标识与系统匹配或者为空时,该命令才会成功。
在将节点添加到系统之前,必须检查是否存在以 下任何情况。如果存在以下情况,未按照此处记录的过程进行操作那么会导致系统管理的所有数据损坏。
  • 是否正在使用新节点替换系统中发生故障的节点?
  • 正在添加到系统的节点是否使用已用作另一个系统中节点的物理节点硬件,并且这两个系统由相同的主机识别?
如果存在上述任何情况,那么必须执行以下操作:
  1. 将节点添加到它先前所在的 I/O 组。您可以使用命令行界面命令 lsnode管理 GUI 来确定系统节点的 WWNN。
  2. 将节点添加回系统之前,请关闭使用此系统的所有主机。
  3. 在重新启动主机之前将节点添加回系统。如果 I/O 组信息不可用或者不方便关闭并重新启动所有使用系统的主机,那么可以执行以下操作:
    1. 在所有连接到系统的主机上,先取消配置光纤通道适配器设备驱动程序、磁盘设备驱动程序和多路径驱动程序,然后再将节点添加到系统。
    2. 将节点添加到系统,然后重新配置光纤通道适配器设备驱动程序、磁盘设备驱动程序和多路径驱动程序。
如果要将节点添加到系统,请执行以下操作:
  1. 确保系统的代码级别支持新节点的型号类型。如果系统代码不支持此型号类型,那么必须将系统升级到支持新节点型号类型的代码版本。
  2. 请记录节点序列号、WWNN、所有 WWPN 以及节点添加到的 I/O 组。稍后您可能会需要使用这些信息。如果必须从集群系统移除节点并将 其重新添加到集群系统,具有这些信息会避免可能发生的数据损坏。
注: 如果系统上每个节点支持透明云分层,那么可以在系统上将其启用。如果系统支持透明云分层,那么不能向系统添加不支持此功能的节点。

在向系统添加节点时的其他注意事项:

使用 addnode 命令或系统 GUI 将节点添加到系统时,必须确认该节点先前是否已成为系统的成员。如果是,请执行以下两个过程之一:
  • 将节点添加到它先前所在的 I/O 组。您可以使用 lsnode 命令确定系统中节点的 WWNN。
  • 如果无法确定集群中节点的 WWNN,请致电支持团队以在不损坏数据的情况下将节点重新添加到系统。

节点添加到系统时,会显示正在添加状态。将节点添加到系统可能需要 30 分钟,尤其是当与节点相关联的代码版本更改时。

注意: 如果节点保持“正在添加”状态超过 30 分钟,请联系支持代表以帮助您解决此问题。

如果节点被删除,那么其名称将作为伙伴节点的故障转移名称保留在 I/O 组中。如果没有节点保留在 I/O 组中,将不保留任何故障转移名称。

如果指定的名称是现有节点名或者保留的故障转移名称,或者如果系统的配置超出了所添加节点的限制,那么 addnode 命令将失败。请为正在添加的节点指定另一个名称。

调用示例

addnode -wwnodename 5005076801e08b -iogrp io_grp0

生成的输出:

Node, id [6], successfully added

调用示例

addnode -panelname 123456 -iogrp 1 -site 2

生成的输出:

Node, id [6], successfully added

调用示例

addnode -wwnodename 5005076801e08b -iogrp io_grp0 -site site1

生成的输出:

Node, id [6], successfully added

调用示例

addnode -panelname 123456 -spare 

生成的输出:

Node, id [7], successfully added